home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / scrnd121.zip / SCRNDISK.DOC < prev    next >
Text File  |  1991-07-30  |  21KB  |  530 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.           SCRNDISK User's Guide                                  -Page 1-
  10.  
  11.  
  12.           Description
  13.           -----------
  14.  
  15.           SCRNDISK is a memory resident screen snapshot utility.  You can
  16.           use SCRNDISK to capture the contents of a 40 or 80 character wide
  17.           text screen to disk.  Each time SCRNDISK's hotkey combination is
  18.           pressed, SCRNDISK will append the image of the current screen to
  19.           the file that you have selected.  SCRNDISK works with text-modes
  20.           only, it will not capture graphics-mode screen images.  ANSI
  21.           graphics, however, since they are displayed in text-mode, can be
  22.           captured with SCRNDISK.
  23.  
  24.           Just before making itself resident, SCRNDISK requests the name of
  25.           the file to which you want it to write the screen snapshots.  Any
  26.           valid DOS filename may be used, in the standard format for file
  27.           identifiers, "drive:path\name.ext".  Specification of the "drive"
  28.           and "path" is optional, but recommended.  The maximum permitted
  29.           length of the filespec is 64 characters.  Examples of valid
  30.           filespecs follow:
  31.  
  32.                            C:\PROJECT\DOCUMENT\SCREENS.IMG
  33.  
  34.                            \PROJECT\DOCUMENT\SCREENS.IMG
  35.  
  36.                            DOCUMENT\SCREENS.IMG
  37.  
  38.                            SCREENS.IMG
  39.  
  40.           The last example would create and append to the file named
  41.           SCREENS.IMG in the current working directory, whatever that
  42.           happens to be each time that SCRNDISK is invoked.  The first
  43.           example would cause SCRNDISK to always append to the file named
  44.           SCREENS.IMG in the subdirectory \PROJECT\DOCUMENT on drive C, no
  45.           matter what the current working directory happens to be each time
  46.           SCRNDISK is invoked.  This "complete" form of the file specifier
  47.           is recommended, to avoid ending up with lots of files scattered
  48.           among your various disks and subdirectories.
  49.  
  50.           Note that if the file does not yet exist when SCRNDISK is
  51.           invoked, it will be created automatically.  SCRNDISK will append
  52.           each snapshot to the end of the file, so a single file will, in
  53.           general, contain images of more than one screen; each image
  54.           occupies 25 lines of the file.  If the "End-of-Screen" mark
  55.           facility is active (see description of the /MarkOn switch,
  56.           below), an additional 3-line marker will be appended after each
  57.           screen image.  If the file to which you are writing screen images
  58.           is erased, moved, or renamed, SCRNDISK will simply create it
  59.           again when the next snapshot is requested.
  60.  
  61.  
  62.           SCRNDISK 1.21 Copyright (C) Ken Bell 1991.  All rights reserved.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.           SCRNDISK User's Guide                                  -Page 2-
  76.  
  77.  
  78.           Installing SCRNDISK
  79.           -------------------
  80.  
  81.           At its simplest, installation may be accomplished by merely
  82.           typing "SCRNDISK /INSTALL" (without the quotes) at the DOS
  83.           prompt.  If you choose this method of installation, SCRNDISK will
  84.           display its banner and ask you to enter the name of the screen
  85.           image file.
  86.  
  87.           If only a filename, without drive and path identifiers, is given,
  88.           the screen image file will be created in the current drive and
  89.           subdirectory.  In fact, if you simply press the <Enter> key
  90.           without typing any filename at all, the default filename,
  91.           SCREEN.IMG, will be used, and the file will be created in your
  92.           current working directory.  I recommend that you specify a full
  93.           pathname so that you may change your current drive and working
  94.           directory freely, while always writing to the same file.  This
  95.           will avoid littering your subdirectories with screen image files.
  96.  
  97.           Although SCRNDISK does not accept a filename from its command
  98.           line, input can be redirected from a file.  You may create a
  99.           response" file containing only the filespec of the file you want
  100.           SCRNDISK to use.  Type the filespec into your response file
  101.           exactly as you would if entering it at the "File:" prompt that
  102.           SCRNDISK normally displays upon installation.  Then, when you
  103.           install SCRNDISK, use DOS' ability to redirect input so that your
  104.           file is used in place of keyboard input.
  105.  
  106.           For example, suppose you want to automatically load SCRNDISK when
  107.           you start your computer, and you want the file to which SCRNDISK
  108.           writes to be named SCREEN.IMG in the \PROJECTS subdirectory of
  109.           your hard drive.  In other words, the file that is to receive
  110.           your screen snapshots will be named C:\PROJECTS\SCREEN.IMG.  To
  111.           accomplish this, you can create a small, plaintext file,
  112.           containing the single line, C:\PROJECTS\SCREEN.IMG.  This
  113.           "response" file can be given any name you wish.  If you name it
  114.           SCRNDISK.INI ("INI" for "initialization") and put in the C:\UTIL
  115.           subdirectory, along with SCRNDISK.COM, you may then include in
  116.           your AUTOEXEC.BAT file the line:
  117.  
  118.                    C:\UTIL\SCRNDISK /INSTALL < C:\UTIL\SCRNDISK.INI
  119.  
  120.           This will cause the pathname contained in SCRNDISK.INI to be
  121.           accepted by SCRNDISK at the time it makes itself resident.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.           SCRNDISK 1.21 Copyright (C) Ken Bell 1991.  All rights reserved.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.           SCRNDISK User's Guide                                  -Page 3-
  142.  
  143.  
  144.           Enabling and Disabling SCRNDISK
  145.           -------------------------------
  146.  
  147.           When resident, SCRNDISK may be in one of two possible states,
  148.           "Enabled" or "Disabled".  When enabled, SCRNDISK will copy the
  149.           current screen image to the specified file, each  time that its
  150.           special hotkey combination has been pressed.  In the disabled
  151.           state, SCRNDISK ignores its hotkey combination, and is
  152.           essentially dormant.  By default, SCRNDISK installs itself in the
  153.           enabled state.
  154.  
  155.           If you prefer, you can override the default by specifying on the
  156.           command line that SCRNDISK should start in the disabled state. 
  157.           For example, if place the command
  158.  
  159.                   SCRNDISK /INSTALL /DISABLE < C:\UTIL\SCRNDISK.INI
  160.  
  161.           in your AUTOEXEC.BAT file, you may leave SCRNDISK disabled until
  162.           you want to start using it, at which time you can enable SCRNDISK
  163.           by typing "SCRNDISK /ENABLE" at the DOS prompt.
  164.  
  165.           By the way, each of SCRNDISK's command switches may be
  166.           abbreviated to their minimum recognizable length, which is
  167.           usually just the first letter of the command.  You may, for
  168.           example, shorten "/ENABLE" to "/E", "/DISABLE" to "/D", and so
  169.           on.  In fact, either "/" or "-" may be used, and the case, upper
  170.           or lower, of the switch is ignored, so "/E", "/e", "-E", and "-e"
  171.           are all equivalent forms of the "/ENABLE" command.  Thus the
  172.           following command is equivalent to the previous example: 
  173.  
  174.                     C:\UTIL\SCRNDISK /I /D < C:\UTIL\SCRNDISK.INI
  175.  
  176.           Another command switch that you might find useful during
  177.           installation (or after, for that matter), is the /KEYS command. 
  178.           By default, SCRNDISK's hotkey combination is the three-key chord,
  179.           "Ctrl-LeftShift-RightShift".  You may prefer a different hotkey
  180.           combination.  Any two or more of the keys {Alt, Ctrl, LeftShift,
  181.           RightShift} may be used to invoke a screen dump.  To change
  182.           SCRNDISK's hotkey combination, specify the first letters of each
  183.           of the desired keys after the /KEYS switch; be sure to leave a
  184.           space, however, between /KEYS and the list of keys.  To expand
  185.           upon our previous example, one can install SCRNDISK in the
  186.           enabled